Skip to content

Remove blinded execution payload envelope - #11091

Merged
gfukushima merged 13 commits into
Consensys-Incorporated:masterfrom
gfukushima:remove-BlindedExecutionPayloadEnvelope
Aug 18, 2026
Merged

gfukushima merged 13 commits into
Consensys-Incorporated:masterfrom
gfukushima:remove-BlindedExecutionPayloadEnvelope

Conversation

@gfukushima

@gfukushima gfukushima commented Aug 13, 2026 •

Copy link
Copy Markdown
Contributor

PR Description

Remove the blinded version of execution payload envelope following the change in the beacon api ethereum/beacon-APIs#624
We now use Eth-Blob-Data-Included to distinguish the request body of publishExecutionPayloadEnvelope

Fixed Issue(s)

Fixes #11044

Documentation

  • I thought about documentation and added the doc-change-required label to this PR if updates are required.

Changelog

  • I thought about adding a changelog entry, and added one if I deemed necessary.

Note

High Risk
Breaking beacon API and validator publish behavior on a consensus-critical path (execution payloads, blob availability, gossip). Misconfigured headers or cross-node block production can cause 400 rejections instead of silent unblind failures.

Overview
Aligns Gloas execution payload publication with the updated beacon API by dropping SignedBlindedExecutionPayloadEnvelope and the unblind-from-cache path. Eth-Blob-Data-Included now selects the body: true → SignedExecutionPayloadEnvelopeContents (blobs in the request), false → SignedExecutionPayloadEnvelope (beacon node attaches blobs/KZG proofs from block-production cache).

Stateful publish builds data column sidecars from the cached getPayload result, with DataColumnSidecarCreationException for missing cache or payload root mismatch (caller-safe rejection messages). ExecutionPayloadPublisherGloas runs sidecar creation in parallel with broadcast validation but does not gossip the envelope until sidecars are ready; if the block has no blob commitments, it may still publish with empty sidecars. Validator remote clients send the signed envelope directly with Eth-Blob-Data-Included: false instead of blinding first.

REST/OpenAPI, validator API channels, and failover blinded routing are updated accordingly; produceBlockV4 treats include_payload as a required query parameter.

Reviewed by Cursor Bugbot for commit b66c5c4. Bugbot is set up for automated code reviews on this repo. Configure here.

…nvelope from PostExecutionPayloadEnvelope, and add `Eth-Blob-Data-Included` header to distiguish between ExecutionPayloadEnvelopeContents and ExecutionPayloadEnvelope when parsing request body

Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Reviewed by Cursor Bugbot for commit 045ebea. Configure here.

Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>
final SignedBlindedExecutionPayloadEnvelope signedBlindedExecutionPayload,
final Optional<BroadcastValidationLevel> broadcastValidationLevel) {
return SafeFuture.<SignedExecutionPayloadEnvelope>of(
return SafeFuture.<List<DataColumnSidecar>>of(

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we abort the entire publish if we can't reconstruct blobs for it? Looks like previously we would still accept the valid signed envelope, and now we won't.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looking into this, I think you're right, not having or being able to reconstruct should be reason enough to stop the publishing of the execution payload.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I do believe the old behaviour was a bug since we a payload without it's sidecar is not valid, we were publishing a payload that would likely fail the import when the time to import come

…atch with the signed execution payload envelope

Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>
…sidecars

Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>
# Conflicts:
#	data/beaconrestapi/src/integration-test/resources/tech/pegasys/teku/beaconrestapi/beacon/paths/_eth_v4_validator_blocks_{slot}.json
Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>
…d reject a payload mismatch

Signed-off-by: Gabriel Fukushima <gabrielfukushima@gmail.com>
…velope' into remove-BlindedExecutionPayloadEnvelope
@gfukushima
gfukushima enabled auto-merge (squash) August 18, 2026 03:55
@gfukushima
gfukushima merged commit 20764a0 into Consensys-Incorporated:master Aug 18, 2026
84 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Aug 18, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[beacon api] remove BlindedExecutionPayloadEnvelope in gloas

2 participants